home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / 8bit / cislib_a / disasm.doc < prev    next >
Text File  |  1995-04-22  |  3KB  |  93 lines
  1.  DISASM.DOC  Don Lebow 70717,720 
  2.  THE STRING INDEXING ROUTINES IN THIS 
  3. PROGRAM ARE BY RICHARD MANSFIELD. MY 
  4. THANKS FOR HIS PERMISSION TO SHARE 
  5. THEM IN MY OWN PROGRAM. 
  6. ONCE THE STRINGS ARE INITIALIZED, YOU 
  7. CAN RE-ENTER THE PROGRAM BY TYPING 
  8. GOTO 70 IN IMMEDIATE MODE. 
  9.  DISASSEMBLER CONVERTS OBJECT CODE 
  10. INTO 6502 SOURCE CODE. THIS IS MOST 
  11. USEFUL FOR US ROOKIES WHEN PRESENTED 
  12. WITH A USEFUL ROUTINE THAT HAS NO 
  13. SOURCE LISTING AND NO CLUES. 
  14.  SINCE DISASM ONLY DISASSEMBLES OBJECT 
  15. CODE THAT IS PRESENT IN MEMORY (ROM 
  16. INCLUDED), THE FIRST MENU ALLOWS YOU 
  17. TO LOAD THE CODE FROM SOME EXTERNAL 
  18. SOURCES. SELECT THE OPTION BY PRESSING 
  19. THE NUMBER KEY. 
  20.  EXCEPT FOR BINARY DISK FILES, WHICH 
  21. CONTAIN THEIR OWN LOAD ADDRESSES, ALL 
  22. LOAD OPTIONS REQUIRE THAT YOU SPECIFY 
  23. A STARTING ADDRESS FOR THE LOAD. THE 
  24. PROGRAM ASKS IF YOU WISH TO USE A 
  25. STRING. IF YOU DON'T, THEN JUST PRESS 
  26. RETURN, AND INPUT THE ADDRESS. ANY 
  27. FREE RAM, INCLUDING PAGE SIX, CAN 
  28. BE USED. IF YOU NEED TO RESERVE LOW 
  29. MEMORY, DO THAT BEFORE LOADING THE 
  30. BASIC PROGRAM. 
  31.  THE 'D:' DEVICE SPEC IS OPTIONAL. 
  32. DISASM USES D1: AS A DEFAULT. 
  33.  DISK FILES MAY BE EITHER DATA FILES 
  34. (HANDY FOR THOSE WEIRD CHARACTER 
  35. STRINGS) OR REGULAR BINARY FILES. 
  36. MULTI-STAGE BINARY LOADS WILL ASK 
  37. FOR PERMISSION TO POKE THE BYTES. 
  38. WHEN THE ENTIRE FILE HAS BEEN READ, 
  39. INPUT THE STARTING ADDRESS FOR 
  40. DISASSEMBLY. 
  41.  DATA READS DATA STATEMENTS, WHICH 
  42. SHOULD BE ENTERED AFTER DISASM HAS 
  43. BEEN LOADED. MAKE SURE THE LINE 
  44. NUMBERS ARE ABOVE 1540. THE PROGRAM 
  45. WILL READ THE WHOLE BLOCK, POKEING 
  46. BYTES STARTING AT THE FIRST ADDRESS 
  47. SPECIFIED. 
  48.  KEYBOARD LETS YOU TYPE IN PROGRAMS 
  49. DIRECTLY. TYPING 999 BACKS UP FIVE 
  50. BYTES, TO CORRECT TYPOS. ANY MINUS 
  51. NUMBER STARTS THE DISASSEMBLY. 
  52.  ONCE THE SCREEN IS FULL, SELECT AN 
  53. OPTION FROM THE MENU BY PRESSING THE 
  54. APPROPRIATE LETTER KEY. C (OR RETURN) 
  55. CONTINUES DISASSEMBLY INLINE. N SHIFTS 
  56. TO A NEW ADDRESS (EG. TO CHECK A JMP 
  57. INSTRUCTION). P DUMPS THE CURRENT 
  58. SCREEN TO THE PRINTER (THE SCREEN 
  59. IS TURNED OFF FOR THIS AND ALL OTHER 
  60. I/O TO SPEED THINGS UP.) E GOES 
  61. TO THE EXIT MENU. 
  62.  FROM THIS MENU, R STARTS OVER FROM 
  63. THE ORIGINAL STARTING ADDRESS. M 
  64. GOES BACK TO THE TOP MENU. Q ENDS 
  65. THE PROGRAM. S WRITES A SOURCE FILE! 
  66.  FIRST CHOICE IS WHETHER TO WRITE A 
  67. REGULAR SOURCE FILE, OR A .BYTE FILE, 
  68. WHICH IS USED FOR TEXT, TABLES, AND 
  69. SUCH. 
  70.  FILES MAY BE WRITTEN TO THE PRINTER. 
  71. INPUT P OR P: FOR A FILENAME. A 
  72. LINECOUNT OPTION IS PROVIDED FOR THOSE 
  73. WITH SINGLE SHEET PRINTERS. IF USING 
  74. CONTINUOUS FEED, INPUT SOMETHING LIKE 
  75. 10000 AT THE PROMPT. WHEN THE COUNT 
  76. IS REACHED, THE PROGRAM WILL HALT 
  77. AND BEEP TO SIGNAL THAT IT'S WAITING 
  78. FOR A KEY PRESS TO CONTINUE. 
  79.  DISK FILES ARE IN LISTED FORMAT, SO 
  80. THEY CAN BE ENTERED INTO ASM/ED, 
  81. MAC/65, OR ANY OTHER LINE ORIENTED 
  82. ASSEMBLER WHICH USES STANDARD OPCODES. 
  83. LINE NUMBERS CORRESPOND TO ADDRESSES, 
  84. SO IF YOU SEE A 'JMP 1608', YOU CAN 
  85. 'LIST 1608' TO SEE WHAT'S THERE. NO 
  86. .ORG ADDRESS IS INCLUDED IN THE FILE. 
  87.  ONCE YOU HAVE THE FILE, DON'T 
  88. RENUMBER IT UNTIL YOU'VE PROVIDED 
  89. LABELS FOR ALL THE APPROPRIATE 
  90. REFERENCES. BUT ONCE YOU DO SO, YOU'LL 
  91. FIND THAT YOU CAN STUDY AND MODIFY 
  92. TO YOUR HEART'S CONTENT. HAVE FUN! 
  93.